Le 25 août 2021 à 13:08, Christophe Nanteuil ***@***.***> a écrit : @christopheNan requested changes on this pull request. Merci pour cette très bonne traduction. Juste quelques remarques. Relu jusqu'à la ligne 1421 In library/pickle.po: > #: library/pickle.rst:33 msgid "The ``pickle`` module **is not secure**. Only unpickle data you trust." msgstr "" +"Le module ``pickle`` **n'est pas sécurisé**. Ne désérialisez d'objets qu'à " ⬇️ Suggested change -"Le module ``pickle`` **n'est pas sécurisé**. Ne désérialisez d'objets qu'à " +"Le module ``pickle`` **n'est pas sécurisé**. Ne désérialisez des objets qu'à " In library/pickle.po: > @@ -35,41 +35,51 @@ msgid "" "avoid confusion, the terms used here are \"pickling\" and \"unpickling\"." msgstr "" "Le module :mod:`pickle` implémente des protocoles binaires de sérialisation " -"et dé-sérialisation d'objets Python. Le *pickling* est le procédé par lequel " -"une hiérarchie d'objets Python est convertie en flux d'octets. *unpickling* " -"est l'opération inverse, par laquelle un flux d'octets (à partir d'un :term:" -"`binary file` ou :term:`bytes-like object`) est converti en hiérarchie " -"d'objets. *Pickling* (et *unpickling*) sont alternativement connus sous les " -"termes de \"sérialisation\", de \"*marshalling*\" [#]_ ou encore de " -"\"*flattening*\". Cependant pour éviter la confusion les termes utilisés ici " -"sont *pickling* et *unpickling*." +"et dé-sérialisation d'objets Python. La sérialisation est le procédé par " +"lequel une hiérarchie d'objets Python est convertie en flux d'octets. La " +"désérialisation est l'opération inverse, par laquelle un flux d'octets (à " +"partir d'un :term:`binary file` ou :term:`bytes-like object`) est converti " +"en hiérarchie d'objets. Sérialisation (et *désérialisation*) sont " +"alternativement connus sous les termes de *pickling*, de \"*marshalling*" ⬇️ Suggested change -"alternativement connus sous les termes de *pickling*, de \"*marshalling*" +"aussi connus sous les termes de *pickling*, de \"*marshalling*" In library/pickle.po: > @@ -151,33 +161,50 @@ msgid "" "differences if your data is crossing that unique breaking change language " "boundary." msgstr "" +"Aucune garantie n'est offerte sur la portabilité du format :mod:`marshal` " +"entre différentes versions de Python. Son gagne-pain étant la gestion des " ⬇️ Suggested change -"entre différentes versions de Python. Son gagne-pain étant la gestion des " +"entre différentes versions de Python. Son fonction première étant la gestion des " In library/pickle.po: > +"adapté. De plus, il vous permet d'outrepasser les différences entre les " +"types Python 2 et Python 3, si vos données se trouvent à cheval sur cette " +"transition unique vers une version non-rétrocompatible." ⬇️ Suggested change -"adapté. De plus, il vous permet d'outrepasser les différences entre les " -"types Python 2 et Python 3, si vos données se trouvent à cheval sur cette " -"transition unique vers une version non-rétrocompatible." +"adapté. De plus, il masque les différences entre les types Python 2 " +"et Python 3, pour le cas où il s'agit de désérialiser en Python 3 des " +"données sérialisées en Python 2." In library/pickle.po: > #: library/pickle.rst:92 msgid "" "There are fundamental differences between the pickle protocols and `JSON " "(JavaScript Object Notation) <http://json.org>`_:" msgstr "" +"Il existe des différences fondamentales entre les protocoles de " +"sérialisation définis par ce module et le format `JSON (JavaScript Object " +"Notation) <http://json.org>`_:" ⬇️ Suggested change -"Notation) <http://json.org>`_:" +"Notation) <http://json.org>`_ :" In library/pickle.po: > +"*pickle* est un format binaire, tandis que JSON est un format textuel (un " +"fichier JSON est constitué de caractères Unicode et généralement encodé en " ⬇️ Suggested change -"*pickle* est un format binaire, tandis que JSON est un format textuel (un " -"fichier JSON est constitué de caractères Unicode et généralement encodé en " +"*pickle* est un format binaire, tandis que JSON est un format textuel " +"(constitué de caractères Unicode et généralement encodé en " Je pense qu'il ne faut pas explicitement restreindre ici aux fichiers, car il s'agit de toute représentation « sortante » du type JSON (donc sous forme de str, io.StringIO, ...). In library/pickle.po: > #: library/pickle.rst:135 msgid "" "The module :mod:`pickletools` contains tools for analyzing data streams " "generated by :mod:`pickle`. :mod:`pickletools` source code has extensive " "comments about opcodes used by pickle protocols." msgstr "" +"Le module :mod:`pickletools` contient des outils servant à analyser les flux " +"de données générés par :mod:`pickle`. Le code source de :mod:`pickletools` " +"contient des commentaires détaillés sur les *opcodes employés par les " ⬇️ Suggested change -"contient des commentaires détaillés sur les *opcodes employés par les " +"contient des commentaires détaillés sur les *opcodes* employés par les " In library/pickle.po: > #: library/pickle.rst:139 msgid "" "There are currently 6 different protocols which can be used for pickling. " "The higher the protocol used, the more recent the version of Python needed " "to read the pickle produced." msgstr "" +"Il existe actuellement 6 protocoles différents pour la sérialisation. Les " +"protocoles portant les numéros les plus grand sont les derniers ajoutés, et " ⬇️ Suggested change -"protocoles portant les numéros les plus grand sont les derniers ajoutés, et " +"protocoles portant les numéros les plus grands sont les derniers ajoutés, et " In library/pickle.po: > #: library/pickle.rst:146 msgid "" "Protocol version 1 is an old binary format which is also compatible with " "earlier versions of Python." msgstr "" +"Le protocole 1 est un ancien format binaire, également compatibles avec les " ⬇️ Suggested change -"Le protocole 1 est un ancien format binaire, également compatibles avec les " +"Le protocole 1 est un ancien format binaire, aussi compatible avec les " In library/pickle.po: > #: library/pickle.rst:153 msgid "" "Protocol version 3 was added in Python 3.0. It has explicit support for :" "class:`bytes` objects and cannot be unpickled by Python 2.x. This was the " "default protocol in Python 3.0--3.7." msgstr "" +"Le protocole 3 a été introduit en Python 3.0. Il support explicitement les " ⬇️ Suggested change -"Le protocole 3 a été introduit en Python 3.0. Il support explicitement les " +"Le protocole 3 a été introduit en Python 3.0. Il gère les " Je ne voie pas de traduction pour « explicit ». In library/pickle.po: > +"données hors bande. Il a également accéléré les opérations sur les données " +"intra-bande. La :pep:`574` contient plus de détails." ⬇️ Suggested change -"données hors bande. Il a également accéléré les opérations sur les données " -"intra-bande. La :pep:`574` contient plus de détails." +"données en marge de la sérialisation elle-même. Il a également accéléré les " +"opérations sur les données à sérialiser. Reportez-vous à la :pep:`574` pour " +"les détails relatifs aux améliorations apportées par le protocole 5." In library/pickle.po: > +"en général. Le module :mod:`pickle` lit et écrit des fichiers, mais ne " +"s'occupe pas de nommer les objets qu'ils contiennent, ni de gérer l'accès " +"par différents processus en parallèle à ces objets. :mod:`pickle` se " ⬇️ Suggested change -"en général. Le module :mod:`pickle` lit et écrit des fichiers, mais ne " -"s'occupe pas de nommer les objets qu'ils contiennent, ni de gérer l'accès " -"par différents processus en parallèle à ces objets. :mod:`pickle` se " +"en général. Le module :mod:`pickle` lit et écrit des objets fichiers-compatibles, mais ne " +"s'occupe pas du problème de donner un nom à des objets persistants, ni de gérer l'accès " +"par différents processus en parallèle à ces objets. :mod:`pickle` se " In library/pickle.po: > +"Écrit la représentation sérialisée de l'objet *obj* dans l' :term:`file " +"object` *file*, qui doit être ouvert. Ceci est l'équivalent de " ⬇️ Suggested change -"Écrit la représentation sérialisée de l'objet *obj* dans l' :term:`file " -"object` *file*, qui doit être ouvert. Ceci est l'équivalent de " +"Écrit la représentation sérialisée de l'objet *obj* dans l'\ :term:`objet " +"fichier-compatible <file object>` *file*, qui doit être ouvert. Ceci est l'équivalent de " In library/pickle.po: > +"Charge la représentation sérialisée d'un objet depuis l' :term:`file object` " +"ouvert *file*, et renvoie l'objet reconstitué obtenu. Ceci est l'équivalent " ⬇️ Suggested change -"Charge la représentation sérialisée d'un objet depuis l' :term:`file object` " -"ouvert *file*, et renvoie l'objet reconstitué obtenu. Ceci est l'équivalent " +"Charge la représentation sérialisée d'un objet depuis l'\ :term:`objet " +"fichier-compatible <file object>` ouvert *file*, et renvoie l'objet reconstitué obtenu. Ceci est l'équivalent " In library/pickle.po: > #: library/pickle.rst:288 msgid "" "Error raised when there is a problem unpickling an object, such as a data " "corruption or a security violation. It inherits :exc:`PickleError`." msgstr "" +"Exception levée lorsqu'un flux binaire ne peut pas être désérialisé, par " +"exemple s'il est corrompu ou. Elle hérite de :exc:`PickleError`." ⬇️ Suggested change -"exemple s'il est corrompu ou. Elle hérite de :exc:`PickleError`." +"exemple s'il est corrompu ou en cas de violation de la sécurité. Elle hérite de :exc:`PickleError`." In library/pickle.po: > +"une valeur fausse (comme ``None``), le tampon est :ref:`hors-bande <pickle-" +"oob>`, sinon il est sérialisée intra-bande dans le flux binaire." ⬇️ Suggested change -"une valeur fausse (comme ``None``), le tampon est :ref:`hors-bande <pickle-" -"oob>`, sinon il est sérialisée intra-bande dans le flux binaire." +"une valeur évaluée comme fausse (telle que ``None``), le tampon est considéré en marge " +"de la sérialisation (ou « :ref:`hors-bande <pickle-oob>` »), sinon il est sérialisé dans le flux binaire." In library/pickle.po: > #: library/pickle.rst:325 msgid "" "It is an error if *buffer_callback* is not None and *protocol* is None or " "smaller than 5." msgstr "" +"Une erreur se produit si *buffer_callback* vautre autre chose que ``None`` " ⬇️ Suggested change -"Une erreur se produit si *buffer_callback* vautre autre chose que ``None`` " +"Une erreur se produit si *buffer_callback* vaut autre chose que ``None`` " In library/pickle.po: > +"Toute autre valeur est émise par le le :class:`Pickler` comme ID persistant " +"pour *obj*. Le sens de cet ID persistant doit être défini par :meth:" ⬇️ Suggested change -"Toute autre valeur est émise par le le :class:`Pickler` comme ID persistant " -"pour *obj*. Le sens de cet ID persistant doit être défini par :meth:" +"Toute autre valeur est reprise par le :class:`Pickler` comme ID persistant " +"pour *obj*. Le sens de cet ID persistant doit être défini par :meth:" In library/pickle.po: > @@ -548,20 +728,32 @@ msgid "" "superfluous PUT opcodes. It should not be used with self-referential " "objects, doing otherwise will cause :class:`Pickler` to recurse infinitely." msgstr "" +"Cet attribut est obsolète. Une valeur vraie désactive la mémorisation des " +"objets au fur et à mesure de leur sérialisation, qui permet habituellement " +"de représenter les doublons par une unique référence. Cette option accélère " +"la sérialisation en évitant des *opcodes* PUT superflus. Elle ne doit pas " +"être utilisée sur un objet contenant une référence à lui-même, car le :class:" +"`Pickler` entrera dans une récursion infinie." ⬇️ Suggested change -"`Pickler` entrera dans une récursion infinie." +"`Pickler` entre alors dans une récursion infinie." In library/pickle.po: > @@ -548,20 +728,32 @@ msgid "" "superfluous PUT opcodes. It should not be used with self-referential " "objects, doing otherwise will cause :class:`Pickler` to recurse infinitely." msgstr "" +"Cet attribut est obsolète. Une valeur vraie désactive la mémorisation des " ⬇️ Suggested change -"Cet attribut est obsolète. Une valeur vraie désactive la mémorisation des " +"Cet attribut est obsolète. Une valeur vraie (« mode rapide ») désactive la mémorisation des " In library/pickle.po: > @@ -586,6 +784,17 @@ msgid "" "datetime`, :class:`~datetime.date` and :class:`~datetime.time` pickled by " "Python 2." msgstr "" +"Les paramètres facultatifs *fix_imports*, *encoding* et *errors* sont dédiés " +"à la compatibilité de la désérialisation avec les flux binaires générés par " +"Python 2. Si *fix_imports* est vrai, *pickle* tentera de modifier les " ⬇️ Suggested change -"Python 2. Si *fix_imports* est vrai, *pickle* tentera de modifier les " +"Python 2. Si *fix_imports* est vrai, *pickle* tente de modifier les " In library/pickle.po: > @@ -586,6 +784,17 @@ msgid "" "datetime`, :class:`~datetime.date` and :class:`~datetime.time` pickled by " "Python 2." msgstr "" +"Les paramètres facultatifs *fix_imports*, *encoding* et *errors* sont dédiés " +"à la compatibilité de la désérialisation avec les flux binaires générés par " +"Python 2. Si *fix_imports* est vrai, *pickle* tentera de modifier les " +"anciens noms des modules que l'on retrouve en Python 2, pour les remplacer " ⬇️ Suggested change -"anciens noms des modules que l'on retrouve en Python 2, pour les remplacer " +"anciens noms des modules que l'on trouve en Python 2, pour les remplacer " In library/pickle.po: > @@ -586,6 +784,17 @@ msgid "" "datetime`, :class:`~datetime.date` and :class:`~datetime.time` pickled by " "Python 2." msgstr "" +"Les paramètres facultatifs *fix_imports*, *encoding* et *errors* sont dédiés " +"à la compatibilité de la désérialisation avec les flux binaires générés par " +"Python 2. Si *fix_imports* est vrai, *pickle* tentera de modifier les " +"anciens noms des modules que l'on retrouve en Python 2, pour les remplacer " +"par ceux en usage en Python 3. Les paramètres *encoding* et *errors* " +"contrôlent la façon de décoder les chaînes de caractères 8 bits. Leurs " +"valeurs par défaut respectives sont 'ASCII' et 'strict'. *encoding* peut " +"être mis à ``'bytes'`` pour lire ces chaînes 8 bits comme *bytes*. Il doit " ⬇️ Suggested change -"être mis à ``'bytes'`` pour lire ces chaînes 8 bits comme *bytes*. Il doit " +"être mis à ``'bytes'`` pour lire des chaînes d'octets en tant que *bytes*. Il doit " ? In library/pickle.po: > #: library/pickle.rst:464 msgid "" "A wrapper for a buffer representing picklable data. *buffer* must be a :ref:" "`buffer-providing <bufferobjects>` object, such as a :term:`bytes-like " "object` or a N-dimensional array." msgstr "" +"Une capsule pour un objet tampon contenant des données sérialisables. " ⬇️ Suggested change -"Une capsule pour un objet tampon contenant des données sérialisables. " +"Encapsule un objet tampon contenant des données sérialisables. " In library/pickle.po: > #: library/pickle.rst:468 msgid "" ":class:`PickleBuffer` is itself a buffer provider, therefore it is possible " "to pass it to other APIs expecting a buffer-providing object, such as :class:" "`memoryview`." msgstr "" +"Les objets :class:`PickleBuffer` prennent eux-mêmes en charge le protocole " ⬇️ Suggested change -"Les objets :class:`PickleBuffer` prennent eux-mêmes en charge le protocole " +"Les objets :class:`PickleBuffer` savent gérer le protocole " In library/pickle.po: > #: library/pickle.rst:503 msgid "tuples, lists, sets, and dictionaries containing only picklable objects" msgstr "" +"les n-uplets, listes, ensembles et dictionnaires, à condition que tous les " ⬇️ Suggested change -"les n-uplets, listes, ensembles et dictionnaires, à condition que tous les " +"les *n*-uplets, listes, ensembles et dictionnaires, à condition que tous les " In library/pickle.po: > @@ -729,6 +981,12 @@ msgid "" "`RecursionError` will be raised in this case. You can carefully raise this " "limit with :func:`sys.setrecursionlimit`." msgstr "" +"Si vous essayez de sérialiser un objet qui ne peut pas l'être, une exception " +"de type :exc:`PicklingError` sera levée. Lorsque cela se produit, il est " ⬇️ Suggested change -"de type :exc:`PicklingError` sera levée. Lorsque cela se produit, il est " +"de type :exc:`PicklingError` est levée. Lorsque cela se produit, il est " In library/pickle.po: > +"Veuillez noter que les fonctions, natives ou non, sont sérialisées par leur " +"simple nom qualifié, et non pas par leur vraie valeur [#]_. La seule " ⬇️ Suggested change -"Veuillez noter que les fonctions, natives ou non, sont sérialisées par leur " -"simple nom qualifié, et non pas par leur vraie valeur [#]_. La seule " +"Veuillez noter que les fonctions, natives ou non, sont sérialisées par référence " +"à leur « nom complètement qualifié », et non pas par leur vraie valeur [#]_. La seule " In library/pickle.po: > #: library/pickle.rst:559 msgid "" "In this section, we describe the general mechanisms available to you to " "define, customize, and control how class instances are pickled and unpickled." msgstr "" +"Dans cette section sont décrits les mécanismes généraux qui s'offrent à vous " +"pour définir, personnaliser, contrôler, la manière dont les instances d'une " ⬇️ Suggested change -"pour définir, personnaliser, contrôler, la manière dont les instances d'une " +"pour définir, personnaliser et contrôler la manière dont les instances d'une " Je pense que c'est plus français ainsi. In library/pickle.po: > @@ -786,12 +1072,21 @@ msgid "" "uninitialized instance and then restores the saved attributes. The " "following code shows an implementation of this behaviour::" msgstr "" +"Dans la plupart des cas, il n'y a besoin de rien pour que les instances " +"d'une classe puissent être sérialisées. Par défaut, *pickle* accède à la " +"classe et aux attributs de l'instance par introspection. Lorsqu'une instance " +"est désérialisée, sa méthode :meth:`__init__` n'est normalement *pas* " +"appelée. Une nouvelle instance est créée sans être initialisée, et ses " +"attributs sont simplement restaurés à partir des valeurs conservées. En " +"d'autre termes, les opérations celles qu'effectue le code suivant::" ⬇️ Suggested change -"d'autre termes, les opérations celles qu'effectue le code suivant::" +"d'autres termes, les opérations sont celles qu'effectue le code suivant ::" In library/pickle.po: > @@ -802,36 +1097,56 @@ msgid "" "dictionary of named arguments for constructing the object. Those will be " "passed to the :meth:`__new__` method upon unpickling." msgstr "" +"Dans les protocoles 2 et suivants, les classes peuvent personnaliser les " +"valeurs passées à la méthode :meth:`__new` lors de la désérialisation. Elles " +"le font en définissant une méthode :meth:`__getnewargs_ex__` qui renvoie un " +"couple ``(args, kwargs)``, où *args* est un n-uplet des arguments " ⬇️ Suggested change -"couple ``(args, kwargs)``, où *args* est un n-uplet des arguments " +"couple ``(args, kwargs)``, où *args* est un *n*-uplet des arguments " In library/pickle.po: > #: library/pickle.rst:600 msgid "" "This method serves a similar purpose as :meth:`__getnewargs_ex__`, but " "supports only positional arguments. It must return a tuple of arguments " "``args`` which will be passed to the :meth:`__new__` method upon unpickling." msgstr "" +"Comme :meth:`__getnewargs_ex__`, mais ne permet que les arguments " +"positionnels. Cette méthode doit renvoyer le n-uplet ``args`` des arguments " ⬇️ Suggested change -"positionnels. Cette méthode doit renvoyer le n-uplet ``args`` des arguments " +"positionnels. Cette méthode doit renvoyer le *n*-uplet ``args`` des arguments " In library/pickle.po: > @@ -849,18 +1169,26 @@ msgid "" "state object to be a dictionary. Otherwise, the pickled state must be a " "dictionary and its items are assigned to the new instance's dictionary." msgstr "" +"Lors de la désérialisation, l'état de l'instance est passé à la méthode :" +"meth:`__setstate__`, si elle est définie. Si elle ne l'est pas, les " ⬇️ Suggested change -"meth:`__setstate__`, si elle est définie. Si elle ne l'est pas, les " +"meth:`__setstate__`, si elle est définie (l'objet *state* n'a pas besoin d'être un dictionnaire). Si elle ne l'est pas, les " In library/pickle.po: > #: library/pickle.rst:663 msgid "" "The interface is currently defined as follows. The :meth:`__reduce__` " "method takes no argument and shall return either a string or preferably a " "tuple (the returned object is often referred to as the \"reduce value\")." msgstr "" +"Voici l'interface de la méthode :meth:`__reduce__`. Elle ne prend aucun " +"argument et renvoie soit une chaîne de caractères, soit (c'est conseillé) un " +"n-uplet. On appelle souvent l'objet renvoyé « valeur de réduction »." ⬇️ Suggested change -"n-uplet. On appelle souvent l'objet renvoyé « valeur de réduction »." +"*n*-uplet. On appelle souvent l'objet renvoyé « valeur de réduction »." In library/pickle.po: > @@ -911,18 +1258,24 @@ msgid "" "Optional items can either be omitted, or ``None`` can be provided as their " "value. The semantics of each item are in order:" msgstr "" +"Si c'est un n-uplet qui est renvoyé, ses éléments sont interprétés dans " ⬇️ Suggested change -"Si c'est un n-uplet qui est renvoyé, ses éléments sont interprétés dans " +"Si c'est un *n*-uplet qui est renvoyé, ses éléments sont interprétés dans " In library/pickle.po: > #: library/pickle.rst:681 msgid "" "A tuple of arguments for the callable object. An empty tuple must be given " "if the callable does not accept any argument." msgstr "" +"Un n-uplet d'arguments passés à cet objet appelable. Donnez un n-uplet vide " ⬇️ Suggested change -"Un n-uplet d'arguments passés à cet objet appelable. Donnez un n-uplet vide " +"Un *n*-uplet d'arguments passés à cet objet appelable. Donnez un *n*-uplet vide " In library/pickle.po: > +"à l'objet un par un avec sa méthode :meth:`append`, ou bien plusieurs à la " +"fois avec sa méthode :meth:`extend`. Ceci est principalement utile aux les " ⬇️ Suggested change -"à l'objet un par un avec sa méthode :meth:`append`, ou bien plusieurs à la " -"fois avec sa méthode :meth:`extend`. Ceci est principalement utile aux les " +"à l'objet un par un avec la méthode :meth:`append`, ou bien plusieurs à la " +"fois avec la méthode :meth:`extend`. Ceci est principalement utile aux les " Je pense qu'il s'agit des méthode de l'objet à désérialiser et non de l'itérateur. In library/pickle.po: > @@ -987,6 +1367,11 @@ msgid "" "of alphanumeric characters (for protocol 0) [#]_ or just an arbitrary object " "(for any newer protocol)." msgstr "" +"Pour les besoins de la persistance, :mod:`pickle` permet des références à " +"des objets en dehors du flux sérialisé. Ils sont identifiés par un ID " +"persistant. Le protocole 0 requiert que cet ID soit être une chaîne de " +"caractères alphanumériques [#]_. Les suivants lui permettent d'être un objet " ⬇️ Suggested change -"caractères alphanumériques [#]_. Les suivants lui permettent d'être un objet " +"caractères alphanumériques [#]_. Les suivants autorisent un objet " — You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub, or unsubscribe. Triage notifications on the go with GitHub Mobile for iOS or Android.